函数
GigE接口函数

GigEVision 设备独有的接口,包含相机IP设置、网络传输模式设置、组播功能和PTP动作命令等接口。 更多...

函数

MV_CAMCTRL_API int __stdcall MV_GIGE_ForceIpEx (IN void *handle, unsigned int nIP, unsigned int nSubNetMask, unsigned int nDefaultGateWay)
 强制IP 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_SetIpConfig (IN void *handle, unsigned int nType)
 配置IP方式 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_SetNetTransMode (IN void *handle, unsigned int nType)
 设置仅使用某种模式,type: MV_NET_TRANS_x,不设置时,默认优先使用driver 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_GetNetTransInfo (IN void *handle, MV_NETTRANS_INFO *pstInfo)
 获取网络传输信息 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_SetGvcpTimeout (void *handle, unsigned int nMillisec)
 设置GVCP命令超时时间 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetOptimalPacketSize (IN void *handle)
 获取最佳的packet size,该接口目前只支持GigE相机 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_SetResend (void *handle, unsigned int bEnable, unsigned int nMaxResendPercent, unsigned int nResendTimeout)
 设置是否打开重发包支持,及重发包设置 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_SetTransmissionType (void *handle, MV_TRANSMISSION_TYPE *pstTransmissionType)
 设置传输模式,可以为单播模式、组播模式等 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_IssueActionCommand (IN MV_ACTION_CMD_INFO *pstActionCmdInfo, OUT MV_ACTION_CMD_RESULT_LIST *pstActionCmdResults)
 发出动作命令 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_SetResendMaxRetryTimes (void *handle, unsigned int nRetryTimes)
 设置重传命令最大重发次数 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_GetResendMaxRetryTimes (void *handle, unsigned int *pnRetryTimes)
 获取重传命令最大重发次数 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_GetResendTimeInterval (void *handle, unsigned int *pnMililsec)
 获取重传包命令重传时间间隔 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_SetResendTimeInterval (void *handle, unsigned int nMililsec)
 设置重传包命令重传时间间隔 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_SetGvspTimeout (void *handle, unsigned int nMililsec)
 设置数据包重发超时 更多...
 
MV_CAMCTRL_API int __stdcall MV_GIGE_GetGvspTimeout (void *handle, unsigned int *pnMililsec)
 获取数据包重发超时 更多...
 

详细描述

GigEVision 设备独有的接口,包含相机IP设置、网络传输模式设置、组播功能和PTP动作命令等接口。

函数说明

◆ MV_GIGE_ForceIpEx()

MV_CAMCTRL_API int __stdcall MV_GIGE_ForceIpEx ( IN void *  handle,
unsigned int  nIP,
unsigned int  nSubNetMask,
unsigned int  nDefaultGateWay 
)

强制IP

参数
handle[IN] 设备句柄
nIP[IN] 设置的IP
nSubNetMask[IN] 子网掩码
nDefaultGateWay[IN] 默认网关
返回
成功,返回MV_OK ;失败,返回错误码
备注
 • 强制设置相机网络参数(包括IP、子网掩码、默认网关),强制设置之后将需要重新创建设备句柄,仅GigEVision相机支持。
 • 如果设备为DHCP的状态,调用该接口强制设置相机网络参数之后设备将会重启。
示例
ForceIP.cpp.

◆ MV_GIGE_SetIpConfig()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetIpConfig ( IN void *  handle,
unsigned int  nType 
)

配置IP方式

参数
handle[IN] 设备句柄
nType[IN] IP类型,见MV_IP_CFG_x
宏定义 宏定义值 含义
MV_IP_CFG_STATIC 0x05000000 固定IP地址模式
MV_IP_CFG_DHCP 0x06000000 DHCP自动获取IP模式
MV_IP_CFG_LLA 0x04000000 LLA(Link-local address),链路本地地址
返回
成功,返回MV_OK ;失败,返回错误码
备注
 • 发送命令设置相机的IP方式,如DHCP、LLA等,仅GigEVision相机支持。

◆ MV_GIGE_SetNetTransMode()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetNetTransMode ( IN void *  handle,
unsigned int  nType 
)

设置仅使用某种模式,type: MV_NET_TRANS_x,不设置时,默认优先使用driver

参数
handle[IN] 设备句柄
nType[IN] 网络传输模式,见MV_NET_TRANS_x
宏定义 宏定义值 含义
MV_NET_TRANS_DRIVER 0x00000001 驱动模式
MV_NET_TRANS_SOCKET 0x00000002 Socket模式
返回
成功,返回MV_OK ;失败,返回错误码
备注
 • 通过该接口可以设置SDK内部优先使用的网络模式,默认优先使用驱动模式,仅GigEVision相机支持。

◆ MV_GIGE_GetNetTransInfo()

MV_CAMCTRL_API int __stdcall MV_GIGE_GetNetTransInfo ( IN void *  handle,
MV_NETTRANS_INFO *  pstInfo 
)

获取网络传输信息

参数
handle[IN] 设备句柄
pstInfo[OUT] 信息结构体
返回
成功,返回MV_OK ;失败,返回错误码
备注
 • 通过该接口可以获取网络传输相关信息,包括已接收数据大小、丢帧数量等,在 MV_CC_StartGrabbing() 开启采集之后调用。仅GigEVision相机支持。

◆ MV_GIGE_SetGvcpTimeout()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetGvcpTimeout ( void *  handle,
unsigned int  nMillisec 
)

设置GVCP命令超时时间

参数
handle[IN] 设备句柄
nMillisec[IN] 超时时间,以毫秒位单位,范围:0-10000
返回
成功,返回MV_OK ;失败,返回错误码
备注
 • 连接设备之后调用该接口可以设置GVCP命令超时时间。
 • 该接口仅在windows版本和Linux版本下支持。

◆ MV_CC_GetOptimalPacketSize()

MV_CAMCTRL_API int __stdcall MV_CC_GetOptimalPacketSize ( IN void *  handle)

获取最佳的packet size,该接口目前只支持GigE相机

参数
handle[IN] 设备句柄
返回
最佳packetsize
备注
 • 获取最佳的packet size,对应GigEVision设备是SCPS,对应U3V设备是每次从驱动读取的包大小,该大小即网络上传输一个包的大小。该接口需要在MV_CC_OpenDevice之后、MV_CC_StartGrabbing之前调用。
示例
ChunkData.cpp, ConnectSpecCamera.cpp, Events.cpp, Grab_ImageCallback.cpp, GrabImage.cpp, GrabImage_HighPerformance.cpp, GrabMultipleCamera.cpp, ImageProcess.cpp, MultiCast.cpp, ReconnectDemo.cpp, Trigger_Image.cpp , 以及 Trigger_ImageCallback.cpp.

◆ MV_GIGE_SetResend()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetResend ( void *  handle,
unsigned int  bEnable,
unsigned int  nMaxResendPercent,
unsigned int  nResendTimeout 
)

设置是否打开重发包支持,及重发包设置

参数
handle[IN] 设备句柄
bEnable[IN] 是否支持重发包
nMaxResendPercent[IN] 最大重发比
nResendTimeout[IN] 重发超时时间
返回
成功,返回MV_OK ;失败,返回错误码
备注
 • 连接设备之后调用该接口可以设置重发包属性,仅GigEVision相机支持。
 • 该接口仅在windows版本和Linux版本下支持。

◆ MV_GIGE_SetTransmissionType()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetTransmissionType ( void *  handle,
MV_TRANSMISSION_TYPE *  pstTransmissionType 
)

设置传输模式,可以为单播模式、组播模式等

参数
handle[IN] 设备句柄
pstTransmissionType[IN] 传输模式结构体
宏定义 宏定义值 含义
MV_GIGE_TRANSTYPE_UNICAST 0 单播
MV_GIGE_TRANSTYPE_MULTICAST 1 组播
MV_GIGE_TRANSTYPE_LIMITEDBROADCAST 2 表示局域网内广播
MV_GIGE_TRANSTYPE_SUBNETBROADCAST 3 表示子网内广播
MV_GIGE_TRANSTYPE_CAMERADEFINED 4 表示从相机获取
MV_GIGE_TRANSTYPE_UNICAST_DEFINED_PORT 5 表示用户自定义应用端接收图像数据Port号
MV_GIGE_TRANSTYPE_UNICAST_WITHOUT_RECV 00010000 表示设置了单播,但本实例不接收图像数据
MV_GIGE_TRANSTYPE_MULTICAST_WITHOUT_RECV 00010001 表示组播模式,但本实例不接收图像数据
返回
成功,返回MV_OK ;失败,返回错误码
备注
 • 通过该接口可以设置传输模式为单播、组播等模式,仅GigEVision相机支持。
示例
MultiCast.cpp.

◆ MV_GIGE_IssueActionCommand()

MV_CAMCTRL_API int __stdcall MV_GIGE_IssueActionCommand ( IN MV_ACTION_CMD_INFO *  pstActionCmdInfo,
OUT MV_ACTION_CMD_RESULT_LIST *  pstActionCmdResults 
)

发出动作命令

参数
pstActionCmdInfo[IN] 动作命令信息
pstActionCmdResults[OUT] 动作命令返回信息列表
返回
成功,返回MV_OK ;失败,返回错误码
备注
 • 仅GigEVision相机支持。

◆ MV_GIGE_SetResendMaxRetryTimes()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetResendMaxRetryTimes ( void *  handle,
unsigned int  nRetryTimes 
)

设置重传命令最大重发次数

参数
handle[IN] 设备句柄
nRetryTimes[IN] 重传命令最大重发次数
返回
成功,返回MV_OK ;失败,返回错误码
备注
nRetryTimes表示重发包1+ nRetryTimes次,0xFFFFFFFF表示不关心

◆ MV_GIGE_GetResendMaxRetryTimes()

MV_CAMCTRL_API int __stdcall MV_GIGE_GetResendMaxRetryTimes ( void *  handle,
unsigned int *  pnRetryTimes 
)

获取重传命令最大重发次数

参数
handle[IN] 设备句柄
pnRetryTimes[IN] 重传命令最大重发次数指针地址
返回
成功,返回MV_OK ;失败,返回错误码
备注
nRetryTimes表示重发包1+ nRetryTimes次,0xFFFFFFFF表示不关心

◆ MV_GIGE_GetResendTimeInterval()

MV_CAMCTRL_API int __stdcall MV_GIGE_GetResendTimeInterval ( void *  handle,
unsigned int *  pnMililsec 
)

获取重传包命令重传时间间隔

参数
handle[IN] 设备句柄
pnMililsec[IN] 重传包命令重传时间间隔指针地址
返回
成功,返回MV_OK ;失败,返回错误码
备注
范围0-0xffffffff

◆ MV_GIGE_SetResendTimeInterval()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetResendTimeInterval ( void *  handle,
unsigned int  nMililsec 
)

设置重传包命令重传时间间隔

参数
handle[IN] 设备句柄
nMililsec[IN] 重传包命令重传时间间隔
返回
成功,返回MV_OK ;失败,返回错误码
备注
范围0-0xffffffff

◆ MV_GIGE_SetGvspTimeout()

MV_CAMCTRL_API int __stdcall MV_GIGE_SetGvspTimeout ( void *  handle,
unsigned int  nMililsec 
)

设置数据包重发超时

参数
handle[IN] 设备句柄
nMililsec[IN] 流数据的收包超时时间,帧接收缓存等待一帧数据的最大时间,超过超时时间后认为一帧接收完
返回
成功,返回MV_OK ;失败,返回错误码
备注
范围10-0xffffffff,默认100ms

◆ MV_GIGE_GetGvspTimeout()

MV_CAMCTRL_API int __stdcall MV_GIGE_GetGvspTimeout ( void *  handle,
unsigned int *  pnMililsec 
)

获取数据包重发超时

参数
handle[IN] 设备句柄
pnMililsec[IN] 超时时间接收指针地址
返回
成功,返回MV_OK ;失败,返回错误码
备注
范围10-0xffffffff,默认100ms